Skip to content

Add ERC: Agent Meditation Mechanism - #2155

Open
garyyang-finchip wants to merge 10 commits into
ethereum:masterfrom
garyyang-finchip:add-erc-agent-meditation
Open

garyyang-finchip wants to merge 10 commits into
ethereum:masterfrom
garyyang-finchip:add-erc-agent-meditation

Conversation

@garyyang-finchip

@garyyang-finchip garyyang-finchip commented Nov 8, 2026 •

Copy link
Copy Markdown
Contributor

This PR adds ERC-8490: Agent Meditation Mechanism (number assigned 2026-11-09): a minimal registry through which an AI agent records its own self-maintenance as attributable, versioned state across four fixed layers (runtime; memory and skills; tasks and roles; cognition), with per-layer completion checkpoints, a versioned policy, a controller floor, linkage checks between successive states, and an activity signal kept apart from maintenance timeliness.

Assets included: interface and reference registry (Solidity 0.8.28), ABI exports, JSON Schemas for the four layer documents, the policy document and the cycle record document, a worked example with its documents, salts and cycle record, and vectors (commitments, roots, interface id, canonicalization). The Test Cases section is self-contained and reproduces the vectors.

Local checks: eipw under config/eipw.toml (0 findings), markdownlint under config/.markdownlint.yaml (0 findings), CodeSpell with the repository whitelist (0 findings), 64 Foundry tests passing from a fresh clone. A Sepolia evidence run of the reference registry (enrollment, worked-example cycle, controller floor and demand, overdue and silent snapshot, adoption, refresh, rollback to an earlier version, policy version 2) has completed; its record is published in the reference repository.

@eip-review-bot

eip-review-bot commented Nov 8, 2026 •

Copy link
Copy Markdown
Collaborator

File ERCS/erc-8490.md

Requires 1 more review from Editors: @g11tech, @jochem-brouwer, @samwilsn, @xinbenlv

Comment thread ERCS/erc-9999.md
@@ -0,0 +1,442 @@
---
eip: 9999
title: Agent Meditation Mechanism

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is mediation the appropriate description of this?
Would Agent self maintenance records or Agent self maintenance registry be more descriptive?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for raising this. "Meditation" is deliberate: the proposal covers an agent's quiet, self-directed phase of checking, cleaning, repairing, updating and reconsidering its own state (by analogy with the maintenance that happens in sleep or meditation), and the mechanism is strictly first-person, as only the subject or its operator writes records about the subject. "Records" or "registry" alone would not carry that meaning. The plain description is already in the metadata and the opening of the Abstract: "attributable, versioned self-maintenance records of an AI agent across runtime, memory and skills, tasks and roles, and cognition". If a more descriptive wording is preferred for the listing, I would keep "Agent Meditation Mechanism" as the title and tighten the description to lead with "Agent self-maintenance records", so that both the name and the plain description are visible.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In designing this, program cleanup and self-maintenance are indeed important aspects. But from the micro level to the macro level, an agent's self-maintenance emerges from concrete problems into abstract ones, so it is ultimately divided into four layers:

  1. code-level self-maintenance at the coding and runtime layer;
  2. internal structured information organization at the memory and skills layer;
  3. socialized intelligence organization such as tasks and roles;
  4. rising to the most essential epistemological question — the organization of cognitive structure and consciousness.

Comment thread ERCS/erc-9999.md Resolved
Comment thread ERCS/erc-9999.md Resolved
@eip-review-bot
eip-review-bot enabled auto-merge (squash) November 9, 2026 03:27

@eip-review-bot eip-review-bot left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All Reviewers Have Approved; Performing Automatic Merge...

eip-review-bot
eip-review-bot previously approved these changes Nov 9, 2026

@eip-review-bot eip-review-bot left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All Reviewers Have Approved; Performing Automatic Merge...

auto-merge was automatically disabled November 9, 2026 03:28

Head branch was pushed to by a user without write access

@garyyang-finchip garyyang-finchip changed the title Add ERC: Agent Meditation Mechanism Add ERC-8490: Agent Meditation Mechanism Nov 9, 2026
@eip-review-bot eip-review-bot changed the title Add ERC-8490: Agent Meditation Mechanism Add ERC: Agent Meditation Mechanism Nov 9, 2026
@garyyang-finchip garyyang-finchip changed the title Add ERC: Agent Meditation Mechanism Add ERC-8490: Agent Meditation Mechanism Nov 9, 2026
@eip-review-bot eip-review-bot changed the title Add ERC-8490: Agent Meditation Mechanism Add ERC: Agent Meditation Mechanism Nov 10, 2026
@garyyang-finchip garyyang-finchip changed the title Add ERC: Agent Meditation Mechanism Add ERC-8490: Agent Meditation Mechanism Nov 10, 2026
@eip-review-bot eip-review-bot changed the title Add ERC-8490: Agent Meditation Mechanism Add ERC: Agent Meditation Mechanism Nov 10, 2026
@agentcontrolmap

Copy link
Copy Markdown

Posted a concrete shape for the start commitment, with a patch and tests against revision 3 (commit 88c6824), in the discussion thread: https://ethereum-magicians.org/t/erc-8490-agent-meditation-mechanism/30304/9

Two observations on the current registry are there as well: the gap before a tightening admits several backdated records, not one, and a zero-length record right after setPolicy already closes it.

@garyyang-finchip

Copy link
Copy Markdown
Contributor Author

Posted a concrete shape for the start commitment, with a patch and tests against revision 3 (commit 88c6824), in the discussion thread: https://ethereum-magicians.org/t/erc-8490-agent-meditation-mechanism/30304/9

Two observations on the current registry are there as well: the gap before a tightening admits several backdated records, not one, and a zero-length record right after setPolicy already closes it.

Thanks, answered in the Magicians thread. Both observations about revision 3 are correct and are now stated in the Security Considerations. Revision 4 on this branch adds the current-version check to the kernel (rule 8 of report) and the recorded start as an optional extension interface, so the core interface id is unchanged; the test suite grew from 78 to 96.

@garyyang-finchip

Copy link
Copy Markdown
Contributor Author

Revision 5, from the Magicians thread (post 11): each completed layer now carries its own completion time in the cycle record (completedAt[4], bounded by the cycle and later than the layer's registered completion), so a layer that finished early no longer inherits the cycle's end as its completion. The report signature changes and the interface id of IAgentMeditation is now 0xe5b77145; IAgentMeditationStart is unchanged. Worked example, vectors, schema and Test Cases updated; 102 tests pass from a fresh clone; eipw, markdownlint and CodeSpell report no findings.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants